home *** CD-ROM | disk | FTP | other *** search
/ Scene 96 / Scene 96 International Edition (Zyklop Software) (Disc 2) (1997).iso / player / cp17 / cp.doc next >
Text File  |  1996-03-30  |  42KB  |  1,123 lines
  1.  
  2.  
  3.   WARNING
  4.  
  5.   this version of CP is released in a hurry. there was no time
  6.   to update the documentation.
  7.  
  8.   the documentation is OUTDATED.
  9.  
  10.   the configuration was changed completely.
  11.  
  12.   most of the commandline parameters vanished, but you'll find some
  13.   information about the configuration in cp.ini
  14.  
  15.   I'm also not quite sure about email.
  16.   Mail us, but do not expect an answer.
  17.   My (pascal's) address might (!) not work and I'm not very keen on
  18.    replying to letters.
  19.   DOJ's address will most probably work.
  20.   ?hook's address works, but will he read the letters in the future?
  21.  
  22.   anyway. deadline for release is today, and so there is no time left to
  23.   check this point. sorry, but cp1.666 is more important than support, don't
  24.   you think so?
  25.  
  26.   distsite requests since 1.6 could not be regarded. sorry. try again.
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.        ▄▄▄▄▄▄▄▄   ▄▄▄    ▄▄▄   ▄▄▄▄▄▄▄▄    ▄▄▄▄▄▄▄▄    ▄▄▄▄▄▄▄▄
  36.      ▄▀        █ █   █  █   █ █        ▀▄ █        █ ▄▀        █
  37.      █  ▄▀▀▀▀▀▀  █   █  █   █ █  ▄▀▀▀▄  █  ▀▀▄  ▄▀▀  █  ▄▀▀▀▀▀▀
  38.      █  █        █   █  █   █ █   ▀▀▀ ▄▀     █  █    █  █
  39.      █  █        █   █  █   █ █   ▄▄▄ ▀▄     █  █    █  █
  40.      █  ▀▄▄▄▄▄▄  █   ▀▄▄▀   █ █  ▀▄▄▄▀  █  ▄▄▀  ▀▄▄  █  ▀▄▄▄▄▄▄
  41.      ▀▄        █ ▀▄        ▄▀ █        ▄▀ █        █ ▀▄        █
  42.        ▀▀▀▀▀▀▀▀    ▀▀▀▀▀▀▀▀    ▀▀▀▀▀▀▀▀    ▀▀▀▀▀▀▀▀    ▀▀▀▀▀▀▀▀
  43.  
  44.                    ·P·L·A·Y·E·R·
  45.  
  46.                    v1.666
  47.  
  48.  
  49.  
  50.    Table of contents
  51.    ==================
  52.    1......................................Introduction
  53.  
  54.    2......................................Using Cubic Player
  55.      2.1..................................General Keys
  56.      2.2..................................Modes and Related Keys
  57.      2.3..................................File Selector
  58.      2.4..................................Command Line Options
  59.  
  60.    3......................................Special Features
  61.      3.1..................................Surrround Sound
  62.      3.2..................................Midi Usage
  63.      3.3..................................Cubic Player and WIN'95 / OS/2
  64.      3.4..................................Intelligent Memory Multiplying (IMM)
  65.      3.5..................................CD-Audio and Sampling Mode
  66.      3.6..................................Double GUS Feature
  67.      3.7..................................Disk Writing
  68.  
  69.    4......................................Notes, Bugs etc.
  70.  
  71.    5......................................Information on Cubic Player
  72.  
  73.    6......................................Greets, Credits
  74.      6.1..................................Addresses
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82. =============================================================================
  83.  
  84.        Attention ! Read the following BEFORE using Cubic Player.
  85.  
  86. =============================================================================
  87.  
  88.     This material  is  not  freeware.  You  are  allowed to
  89.     copy it  without  restrictions for non-commercial  use.
  90.     No payment  of any kind may be charged for this product
  91.     or  any combination of products  or services  including
  92.     this  product  without our  authorization  and official
  93.     written  license.  Commercial use,  especially the
  94.     industrial manufacturing on any  data storage media and
  95.     their  distribution  without  the expressed  permission
  96.     of  the producer, is strictly prohibited.  This program
  97.     or the data files contained therein may  not be altered
  98.     or modified without the permission of the author.
  99.     You  take full responsibility for the operation of this
  100.     software and any consequences thereof.  We the creators
  101.     cannot accept liability for damages or failures arising
  102.     from the use of this software.
  103.  
  104.         For further information refer to the addresses section.
  105.  
  106.  
  107. =============================================================================
  108.  
  109.    1: Introduction
  110.    ================
  111.  
  112.       Cubic Player (CP) is a music player which plays a variety of
  113.       sound formats on several sound cards.
  114.       The player supports the following sound cards:
  115.        -Gravis UltraSound
  116.        -SoundBlaster 1.x / 2.x / Pro / 16 / AWE 32
  117.        -WSS compatible cards / UltraSound MAX / UltraSound DaughterBoard
  118.        -Pro Audio Spectrum series
  119.        -Disk Writer, writes .WAV output on disk.
  120.        -Quiet Player =)
  121.       and the following music formats:
  122.        MOD/NST/WOW, XM, S3M, DMF, MTM, ULT, 669, OKT, PTM, AMS, MDL and MIDI.
  123.       If you encounter any problems with this product NOT mentioned
  124.       in the text, feel free to contact us. (adresses listed below).
  125.  
  126.       The player works with Windows 3.x, Windows '95 and OS/2 warp.
  127.       Maybe it does not always work with Windows 3.x, but it should
  128.       finally work with '95.
  129.  
  130.  
  131.  
  132.    2: Using Cubic Player
  133.    ======================
  134.  
  135.       Take your time to read this chapter, or you'll miss some of
  136.       the advanced options of Cubic Player...
  137.  
  138.       You can simply start the player without command line options [and
  139.       filenames], the player will try to detect your sound device and start
  140.       playing the specified files.
  141.       If you have not specified any files, you will enter the fileselector
  142.       and can select a list of files of your choice.
  143.       After that you'll most probably find yourself in the instruments
  144.       screen.
  145.  
  146.  
  147.    2.1: General Keys:
  148.    -------------------
  149.  
  150.       these keys are valid throughout the player. (not in the fileselector)
  151.  
  152.       2.1.1: Very very general keys...
  153.       ---------------------------------
  154.  
  155.        F1 / ? / H   : Online HELP
  156.               scroll with pgup and pgdn or ctrl-pgup/dn.
  157.               if the Help window :) is too small press z
  158.  
  159.        return       : next module
  160.  
  161.        p            : II / =>   (pause and play)  have fun... ;)
  162.        ctrl-p       : this is a faster version of pause...
  163.        alt-p        : idle mode. stop screen output and wait for key!
  164.                 nice thing for multitaskers.
  165.  
  166.        d            : advanced dos-shell!
  167.        ctrl-d       : less advaned dos-shell... (no top line patching)
  168.  
  169.        f            : fileselector (see. 2.3 for usage)
  170.  
  171.        z            : toggle vertical screen size (25/50 lines)
  172.        alt-z        : toggle horizontal screen size (80/132 rows)
  173.        ctrl-z       : toggle vertical screen size (25/30 lines)
  174.  
  175.        esc esc      : the taboo keys... :)
  176.                quite useless feature, I think
  177.  
  178.  
  179.       2.1.2: Module Specific Keys
  180.       ----------------------------
  181.  
  182.     with these keys you can walk around in the song,
  183.     you have to press ctrl for all of them.
  184.  
  185.        ctrl-right   : go to next pattern
  186.        ctrl-left    : go to previous pattern
  187.        ctrl-up      : go 8 rows up in current pattern (rewind)
  188.        ctrl-down    : go 8 rows down in current pattern (forward)
  189.        ctrl-home    : restart the current song
  190.  
  191.  
  192.       2.1.3: Channel Options
  193.       -----------------------
  194.     The channels are displayed in all textmodes. In the graphic modes
  195.     there is a small box with the channel to let you know which channels
  196.     are active at the moment and which channel is selected.
  197.     There are 3 channel display modes toggled by c:
  198.       -no display: does exactly what it implies.
  199.       -small channels: shows from left to right:
  200.         instrument number, note, volume, effect and volume bars
  201.       -big channels: shows from left to right:
  202.         instrument name, note, note effect, volume, volume effect,
  203.         panning, panning effect, effect (written) and volume bars
  204.  
  205.     If a note is struck it will be cyan for the current row.
  206.     The note, volume and panning effects are described in 2.2.2.2.2
  207.  
  208.  
  209.     2.1.3.1: Channel Keys
  210.     ----------------------
  211.  
  212.        c            : changes the size of the channel display
  213.  
  214.        left / right : go to previous / next channel
  215.        up   / down  : go to prev / next channel with wrap-around
  216.        q            : toggle currently selected channel
  217.        s            : solo channel
  218.        1 2 3 .. 0   : goto and toggle channel 1 .. 10
  219.        ctrl-1 .. 0  : goto and solo channel   1 .. 10
  220.        ctrl-q/ctrl-s: turn on all channels
  221.  
  222.  
  223.       2.1.4: Volume Options
  224.       ----------------------
  225.  
  226.     these keys are for volume, stereo fx, speed etc.
  227.     they are arranged like the 2nd line on the screen for easy usage.
  228.  
  229.        F2 F3        : dec/inc the master volume
  230.         + -         : this lets you adjust the m.vol. more precisely
  231.  
  232.        ctrl-F2/F3   : dec/inc the amplification level,
  233.               this takes a little bit of time on sb, so be careful
  234.               (We won't take responsibility for your ears..)
  235.  
  236.        F4           : toggle surround (only stereo and Sound Blaster)
  237.               flips one channel, makes the sound surround you...
  238.               a nice options for headphones or if you have
  239.               4 speakers installed, (you can find a description
  240.               of how to set them up below) and even if you don't.
  241.               You will only hear it if some of the output is
  242.               equal on both channels... (combine it with panning)
  243.               does not work on a GUS of course!
  244.  
  245.        F5 F6        : slide panning. panning shifts the sound to
  246.               the middle or exchanges the channels with each other
  247.  
  248.               if you use headphones, set the panning to somewhere
  249.               in between middle and full. it will sound much much
  250.               much much better!!!
  251.         , .         : finer panning
  252.  
  253.        F7 F8        : slide balance
  254.         / *         : fine balance
  255.  
  256.        F9  F10      : dec/inc playback speed (see ctrl-F12)
  257.        F11 F12      : dec/inc pitch (see ctrl-F12)
  258.  
  259.        ctrl-F11     : toggle fine speed and pitch control.
  260.  
  261.        ctrl-F12     : toggle speed and pitch lock.
  262.               if on, a change in speed also will affect the pitch
  263.                 and vice versa
  264.  
  265.        ctrl-F4      : toggle effects view
  266.  
  267.        ctrl-F5/F6   : dec/inc reverb send level (AWE only)
  268.  
  269.        ctrl-F7/F8   : dec/inc chorus send level (AWE only)
  270.  
  271.        backspace    : toggle oversampling interpolation (off/AOI/FOI)
  272.  
  273.        alt-backspace: toggle the amazing 32-bit-fast-fake-interpolation
  274.  
  275.        ct-backspace : change filter, pretty useless with high sampling
  276.               rates... 3 different filters with increasing effect
  277.               and 32-bit-fast-fourier-interpolation
  278.               (SB only again !)
  279.  
  280.        alt-F2       : save the current values for panning, balance,
  281.               amplification, filter/FFI, pitch etc.
  282.        alt-F3       : load previously saved values
  283.        alt-F4       : load factory defaults
  284.  
  285.  
  286.  
  287.    2.2: Modes and Related Keys
  288.    ----------------------------
  289.  
  290.       Note: all previously listed keys are still valid in all modes.
  291.  
  292.        h    ?   F1  : Help Mode (should be self-explanatory)
  293.        i            : Instrument Mode (2.2.1)
  294.        m            : View Song Message (MTM/DMF), keys like in help mode
  295.        t            : Pattern View (2.2.2)
  296.        a            : Text Mode Spectrum Analyser (2.2.3)
  297.        g            : Graphic Spectrum Analyer (2.2.4)
  298.        o            : Scopes (2.2.5)
  299.        n            : Note Dots (2.2.6)
  300.        w            : Würfel mode, höhö.. (see yourself)
  301.        x            : EXTENDED MODE... beat it!!!
  302.        e            : Echo Editor (2.2.7)
  303.  
  304.  
  305.       2.2.1: Instrument Mode   <i>
  306.       -----------------------------
  307.     The usual instrument display... a bit more comfortable than others!
  308.  
  309.        tab          : toggle between short and long instruments
  310.        pgup / pgdn  : scroll
  311.        ctrl-pgup/dn : scroll fast
  312.        home         : go home!
  313.        alt-i        : clear instrument used flags... wow!
  314.  
  315.  
  316.       2.2.2: Pattern View   <t>
  317.       --------------------------
  318.  
  319.     it's really simple:
  320.     colors indicate the type of effect:
  321.  
  322.     2.2.2.1: Global Effects
  323.     ------------------------
  324.        green   speed commands     (tempo, speed)
  325.        red     position commands  (break, goto, patloop, patdelay)
  326.        blue    global vol fx      (set glob vol, glob vol slide)
  327.  
  328.     2.2.2.2: Channel Effects
  329.     -------------------------
  330.        white   instrument effect  (set instrument, play note, etc.)
  331.        green   pitch effect       (porta, vibrato, arpeggio, etc.)
  332.        blue    volume effect      (set volume, volslide, tremolo, etc.)
  333.        purple  panning effect     (set panning, panning slide)
  334.        red     note effect        (cut note, delay note, etc.)
  335.  
  336.     the symbols/letters indicate the effect, the values are given in hex
  337.     volumes: 00-FF in contrast to volumes in most module formats (00-40)
  338.     panning: 00-FF from full left to full right
  339.     first instrument is 00 not 01.
  340.  
  341.     2.2.2.2.1: Global Effects
  342.     --------------------------
  343.        green   tXX       tempo, the number of ticks per row
  344.            sXX       speed, the number of ticks per time
  345.        red     downXX    break pattern and start next one in row ??
  346.            rightXX   goto pattern
  347.            plX       pattern loop: 0 set label, others: loop ? times
  348.            pdX       delay pattern for ?*tempo ticks
  349.        blue    vXX       set global volume
  350.            upXX      global volume slide up
  351.            downXX    global volume slide down
  352.            updown00  continue last global volume slide
  353.  
  354.     2.2.2.2.2: channel effects
  355.     --------------------------
  356.        white   iXX       set instrument
  357.            C-4...    play note C, octave 4
  358.            off       key off (XM only)
  359.            rightXX   set envelope position (XM only)
  360.        green   C-4...    set porta to note note         (porta to note)
  361.            up??      pitch slide up   00: cont      (porta up)
  362.            downXX    pitch slide down 00: cont      (porta down)
  363.            +XX       row pitch slide up             (finetune)
  364.            -XX       row pitch slide down           (finetune)
  365.            noteXX    pitch slide to note 00: cont   (porta to note)
  366.            ~XX       vibrato
  367.            ~rightX   vibrato set speed
  368.            ~=X       vibrato set waveform
  369.            ≡XX       arpeggio
  370.        blue    vXX       set volume
  371.            upXX      volume slide up
  372.            downXX    volume slide down
  373.            +XX       row volume slide up            (finevol)
  374.            -XX       row volume slide down          (finevol)
  375.            ~XX       tremolo
  376.            ~=X       set tremolo waveform
  377.            ⌐XX       tremor, does anyone use it?
  378.        purple  pXX       set panning
  379.            rightXX   panning slide right
  380.            leftXx    panning slide left
  381.            >face<    enable surroud sound for channel (see below)
  382.        red     dXX       delay, delays anything, usually notes
  383.            !!XX      retrigger
  384.            rightXX   sample offset
  385.            ^XX       note cut
  386.  
  387.     2.2.2.3: Keys in Pattern View
  388.     ------------------------------
  389.  
  390.          space  : toggle auto / manual mode
  391.       ctrl-pgup/dn  : scroll instruments
  392.           home  : set optimum mode for current module
  393.  
  394.            auto mode:
  395.        pgup / pgdn  : change number of channels: 32,24,16,8,4
  396.            tab  : toggle mode (fx on/off etc)
  397.  
  398.          manual mode:
  399.        pgup / pgdn  : move through patterns
  400.        [shift]-tab  : change # of channels, mode
  401.  
  402.  
  403.       2.2.3: Text Mode Spectrum Analyser   <a>
  404.       -----------------------------------------
  405.     On faster computers the spectrum analyser can look a bit dirty.
  406.     This is because the player does not wait for a refresh when displaying.
  407.     A decay speed is not yet included.
  408.  
  409.        a / alt-F5   : toggle channel mode (all/current)
  410.       ctrl-pgup/dn  : scroll instruments
  411.        pgup / pgdn  : change visible frequency range
  412.        home         : set maximum freq to approximately 3000Hz
  413.        tab          : change colors
  414.  
  415.  
  416.       2.2.4: Graphic Spectrum Analyser   <g>
  417.       ---------------------------------------
  418.     That kind of stripes that are used in voice recognition...
  419.     Watch the vibratos!!! wow.. that's cool..
  420.       have a look at guitarsl.mod, armani.s3m and space.mod
  421.  
  422.        g / alt-F3   : toggle channel mode:
  423.                 - both output channels
  424.                 - mixed output channels
  425.                 - currently selected channel only
  426.        alt-g        : toggle between fast and fine mode
  427.        pgup / pgdn  : change visible frequency range
  428.        home         : set maximum frequency to approximately 3000 Hz
  429.        tab ctrl-tab : change scale / palette
  430.  
  431.        NEW: shift-g : The Big-GSA !!!! on amazing 1024x768 resolution
  432.               (we wish you a Pentium for this mode :-)
  433.  
  434.  
  435.       2.2.5: Scopes   <o>
  436.       --------------------
  437.  
  438.     Just simple oscilloscopes for all or one channel
  439.     The background piccy needs an extra 250k of memory, if you don't have
  440.     that much you can disable the picture with a command line option.
  441.  
  442.        o alt-F2     : toggle mode (master/single/all)
  443.        alt-o        : toggle trigger, starts the output on a
  444.               polarity change
  445.        pgup / pgdn  : stretch scopes
  446.  
  447.  
  448.       2.2.6: Note Dots <n>
  449.       ---------------------
  450.  
  451.     They really look c00l, because they use the real pitch and
  452.     the real volume...
  453.  
  454.        n            : toggle between dots, bars, stereo cones and
  455.               stereo dots!
  456.        pgup/dn      : slide range
  457.        ctrl-pgup/dn : slide scale
  458.  
  459.  
  460.       2.2.7: Echo Editor <e>
  461.       -----------------------
  462.  
  463.     Yeah, now it's here. The ultimate Echo Online Editor you have
  464.     long waitet for. Create your own Echos with 8 or 16bit quality and
  465.     up to 8 different generators. Or simply pick one of the predefined
  466.     Echos and enjoy your tunes with the glorious sound of Cathedral II.
  467.     (Echos are only available on SB and GUS MAX/WSS)
  468.  
  469.     Selector Keys
  470.     --------------
  471.  
  472.        enter        : use the currently selected echo
  473.  
  474.        ctrl-up/down : move the echo in list
  475.        ctrl-del     : delete echo from list
  476.        ctrl-ins     : store the echo from the editor at the current
  477.               position and save the echo list.
  478.  
  479.        tab          : jump to editor copying the current echo
  480.  
  481.        esc          : leave echo selector / editor returning to cp
  482.  
  483.     Editor Keys / Usage
  484.     --------------------
  485.  
  486.       At first you have to select how many Operators your echo should
  487.       have in the field OPNUM. Up to 8 Operators are possible.
  488.       Then you should define the maximum delay in 0.1 ms. This will have
  489.       an effect on the memory requierements of the echo. Then the general
  490.       feedback FB should be set. The higher the value the more often the
  491.       echo signal is passed in the generator (the louder and stronger the
  492.       echo will appear).
  493.       Now type in the delay of the Operators in 0.1 ms and their feedback
  494.       volume (volumes can be negative, that means the samples will be
  495.       player reversed).
  496.       At last you can choose a name and 8 or 16bit mixing (of course
  497.       16bit mixing takes more resources, but especially with modules
  498.       above 16 channels or MIDIs 8bit mixing does not work anymore,
  499.       you have to choose 16bit mixing (this has technical reasons))
  500.       You can also slide the values by pressing pgup/dn
  501.  
  502.       If you have created interesting and new echos or any comments
  503.       the the echo function feel free to contact us!
  504.  
  505.       btw: chorus will not often have much effect on the output...
  506.  
  507.  
  508.  
  509.    2.3: FileSelector   <f> <ins>
  510.    ------------------------------
  511.       An easy way to search and play your favourite modules
  512.       now in version ][. now caches modules... reads from zips...
  513.       reads, edits and writes module information files
  514.  
  515.       At first it scans the current directory for modules (files with
  516.       the extension .MOD .S3M .XM, .MID...) and lets you select
  517.       files. While you do this, it scans the modules for the titles
  518.       and number of voices. This can be very slow on disks and CDs and you
  519.       can stop it by pressing ctrl-backspace. If you've found a nice module
  520.       you can either play it now by pressing return or put it in the
  521.       playlist with -> or ins. There is also a quickfind feature: Simply
  522.       type the name of the module and the fileselector will go to the
  523.       file. (You don't need to complete the name or type it correctly,
  524.       it will take the name that is most similar to the typed name)
  525.       When you have finished the playlist, hit esc. Remember: return plays
  526.       the currently selected module.
  527.  
  528.  
  529.       2.3.1: Keys for Fileselector
  530.  
  531.        up, down,
  532.        pgup, pgdn,
  533.        home, end    : the usual stuff...
  534.  
  535.        abc123...    : quickfind
  536.  
  537.        return       : play selected module RIGHT NOW!
  538.        esc          : leave fileselector, don't interrupt current mod
  539.  
  540.        ins    ->    : add mod to list      (both windows)
  541.        del    <-    : remove mod from list (both windows)
  542.  
  543.        ctrl-left,
  544.        ctrl-ins     : add all mod in current directory to list
  545.        ctrl-right,
  546.        ctrl-del     : clear playlist
  547.  
  548.        tab          : toggle "window"
  549.        shift-tab    : toggle editor (pgup/dn in editor for move in list)
  550.        alt-tab      : toggle view mode
  551.  
  552.        ctrl-up, down: move mod in playlist
  553.        pgup, pgdn,  :  (my god, why do i do this?? no one will ever use
  554.        home, end    :   this feature...)
  555.  
  556.        ctrl-backspc : stop reading module info
  557.        alt-s        : if ctrl-backspace does not work
  558.  
  559.        alt-z        : toggle 80*25 / 132*60 lines mode
  560.        alt-c        : configuration menu (session only, not permanent!)
  561.        alt-a        : write module information file for dir/list.
  562.        alt-w        : write module information file for sel. mod.
  563.        alt-i        : toggle view mode
  564.        alt-k        : zap this file!
  565.  
  566.  
  567.  
  568.    2.4: Command Line
  569.    ------------------
  570.  
  571.     At the command line you can specify the modules you wish to play.
  572.     This works very much like the dos DIR command, e.g. type
  573.       cp d:\mods\guitarsl
  574.       cp \mods
  575.       cp \mods\.xm
  576.       cp .
  577.       cp c:
  578.  
  579.     You can also give a playlist: cp @d:\mods\favorite.lst
  580.     (playlists can be nested, though this feature has not yet
  581.      been tested extensively)
  582.     NOTE: This feature is not available at the moment due to complete
  583.           rebuilt of the fileselector and leck of time.
  584.  
  585.     if you have not specified any modules or none of them could be found
  586.     cp will start up with the file selector.
  587.  
  588.  
  589.       2.4.1: Usage of Command Line Options etc.
  590.       ------------------------------------------
  591.  
  592.     The command line options are arranged in groups:
  593.        -h[n]:  view help screen #n
  594.        -c:  2.4.2: Sound Device Specific Switches
  595.        -v:  2.4.3: Volume Specific Switches
  596.        -w:  2.4.4: Screen Specific Switches
  597.        -f:  2.4.5: Fileselector Specific Switches
  598.        -m:  2.4.6: Midi Switches
  599.  
  600.     You can use switches everywhere in the command line, you can
  601.     also set default values with the environment variables CP in the
  602.     file CP.CFG in CP.EXE's path.
  603.     The format is always the same, all switches begin with - or /
  604.     Switches of the same group can be put together separated by a ,
  605.     (no whitespaces in between!):
  606.       -cb -cc0 == -cb,c0
  607.  
  608.       -h            : This is a pretty good feature if you don't know
  609.       -?            : all the switches by heart
  610.  
  611.       2.4.2: Sound Device Specific Switches
  612.       --------------------------------------
  613.       -c...
  614.         c??         : sounddevice
  615.                 0  : quiet
  616.                 1  : SoundBlaster 1.x
  617.                 2  : SoundBlaster 2.x
  618.                 3  : SoundBlaster Pro
  619.                 4  : SoundBlaster 16
  620.                 5  : SoundBlaster AWE
  621.                 10 : Gravis UltraSound
  622.                 11 : Double GUS 2D
  623.                 12 : Double GUS 3D
  624.                 20 : Windows Sound System WSS,
  625.                 21 : GUS MAX CODEC
  626.                 22 : GUS + 16bit daughterboard
  627.                 30 : Pro Audio Sprectrum Series
  628.                 40 : Disk Writer
  629.         p???        : port in hex
  630.         z???        : secondary port
  631.         i??         : irq in dec
  632.         j??         : secondary irq
  633.            ATTENTION! ALL IRQs MUST BE BELOW 8 WHEN USING DOS4GW
  634.         d?          : dma
  635.         e?          : secondary dma
  636.         r?????      : sampling rate in Hz or kHz
  637.         q?????      : sampling rate for 32 channels
  638.         b[-]        : bypass mode [off], bypasses the detect/check
  639.               routines, make sure to set all parameters correctly!
  640.         m           : mono
  641.         s           : stereo
  642.         8           : eight bit
  643.         16          : sixteen bit
  644.         l[+]        : small buffer, if you think the sound output is too
  645.               much behind. this could cause trouble on slower
  646.               systems, mods with many channels or if echo is
  647.               enabled
  648.         g[+]        : slow gus upload: if dma or irq does not work.
  649.         t[+]        : use system timer: if irq does not work.
  650.  
  651.  
  652.       2.4.3: Volume Specific Switches
  653.       --------------------------------
  654.       -v...
  655.         v??       : master volume: 0%..100%, default 100%
  656.         a???      : amplify: 0%..400%, default 100%
  657.         p???      : panning: -100%..+100%, default 100%
  658.         b???      : balance: -100%..+100%, default 0%
  659.         s[-]      : surround sound [off]
  660.         f?        : lowpass filter 0..4 -
  661.                 0 : none
  662.                 1 : very soft
  663.                 2 : soft
  664.                 3 : middle
  665.                 4 : effective
  666.                 5 : 32-bit Fast-Fake-Interpolation
  667.                 6 : 48-bit Adaptive-Oversampling-Interpolation
  668.                 7 : 64-bit Full-Oversampling-Interpolation
  669.  
  670.       2.4.4: Screen Specific Switches
  671.       --------------------------------
  672.       -w...
  673.         c[+/-]      : channels: short, +:long, -:none
  674.         zxx         : text mode: 0: 80x25, 1: 80x30, 2: 80x50, 3: 80x60
  675.                      4:132x25, 5:132x30, 6:132x50, 7:132x60
  676.         cxx         : channel display type xx:
  677.               0:none, 1:short, 2:long, 3:side
  678.         ixx         : instrument display type xx:
  679.               0:none, 1:short, 2:long, 3:side
  680.         a[-]        : turn spectrum analyser on [off]
  681.         t[-]        : turn pattern view on [off]
  682.         x           : display very much! (extended mode)
  683.         sx          : startup screen x: o/g/i/a/t/w  (see 2.2)
  684.         p[+]        : don't [do] load scope background picture
  685.               [requires 200k mem]
  686.  
  687.       2.4.5: Fileselector Switches
  688.       ----------------------------------
  689.       -f...
  690.         l[+]        : don't [do] loop modules
  691.         o[-]        : don't [do] scramble playlist order
  692.         r[+]        : don't [do] remove mods from list if played
  693.         a[+]        : don't [do] scan archives
  694.         n[+]        : don't [do] scan module names
  695.         b[+]        : don't [do] scan in (ZIP) archives
  696.         i[+]        : don't [do] scan module information files
  697.         w[+]        : don't [do] write module information cache files
  698.         e[+]        : don't [do] show module information window
  699.         c[+]        : don't [do] use different colors for different types
  700.         z??         : screen size (see -wz)
  701.         pPATH       : startup path in the fileselector (also affects
  702.                          command line modules)
  703.  
  704.  
  705.       2.4.6: Midi Switches
  706.       ---------------------
  707.       -m...
  708.         cnn         : use nn channels for midi output
  709.         ppath       : path of the gus-patches
  710.  
  711.  
  712.  
  713.  
  714.  
  715.    3: Special Features
  716.    ====================
  717.  
  718.    3.1: Surround Sound
  719.    --------------------
  720.  
  721.    This sounds pretty nice if you have a stereo non-wavetable soundcard.
  722.    Just buy 1,2 or 3 additional speakers, connect them as shown below
  723.    and press F4 (and F5 twice if you want) in Cubic Player.
  724.  
  725.                Stereo
  726.         + L -           - R +
  727.            +-+ +-+         +-+ +-+
  728.            +-+ +-+         +-+ +-+
  729.         I   I           I   I
  730.         I   I           I   I
  731.        +----+   +-----+-----+   +-----+
  732.        I    I         I         I     I
  733.        I    I         I         I     I
  734.        I    I         -         I     I
  735.        I    I     M-Speaker     I     I
  736.        I    I         +         I     I
  737.        I    I         I         I     I
  738.        I    +   - ----+---- -   +     I
  739.        I  L-Speaker        R-Speaker  I
  740.        I                              I
  741.        I                              I
  742.        +---+  +-------------+  +------+
  743.            I  I             I  I
  744.            +  -             -  +
  745.          S1-Speaker      S2-Speaker
  746.  
  747.        Thanks to Michael Erdmann for this diagram.
  748.        (we cannot be made liable for burning equipment, etc.)
  749.  
  750.  
  751.    3.2: Midi usage
  752.    ----------------
  753.  
  754.    You have to have the GUS patches for midi support. If you haven't got a
  755.    GUS you can find them on many BBSs, they usually come as "GUS-drivers"
  756.    and are about 5-6 disks big. GUS users can skip the following part.
  757.    (hey, don't mess around with the default.cfg, this can cause errors,
  758.     if you make changes to the default.cfg, that refuse to work with cp,
  759.     make a copy of the original one and call it cpmidi.cfg)
  760.    After installing them into any directory, add the following statement
  761.    to cp.cfg:  (if there is no cp.cfg yet, create it in the cp directory)
  762.  
  763.     -mpPATH    where PATH is the directory of your gus-patches.
  764.  
  765.    In midi mode, some options are disabled and some will look different.
  766.    (not all midi effects are processed at the moment, so if you've got
  767.    information on midis or the gus patches, contact us!)
  768.  
  769.  
  770.  
  771.    3.3: Cubic Player and WIN'95 / OS/2
  772.    ------------------------------------
  773.      if you want to run cp in the background press alt-p to stop all
  774.      screen output and enter idle mode. press any key to continue.
  775.  
  776.  
  777.      Windows 95:
  778.      -----------
  779.    CP should now work satisfactory with Win'95. We have not tested it
  780.    ourselves, but heard that it works. If you experience problems with
  781.    it, please tell us.
  782.  
  783.      OS/2:
  784.      -----
  785.    Yes, Cubic Player works with OS/2 v3. Simply create a Program-Object
  786.    from the Template-Folder. Select DOS-Fullscreen from the Session-Settings
  787.    (NO, it does NOT run in a window.) Make sure to put DOS4GW.EXE as the
  788.    executable and CP.EXE as parameter. Cubic Player should now work with the
  789.    standard DOS-Settings.
  790.    If your soundcard is not detected properly, specify it manually in your
  791.    cp.cfg (See section 2.4 on this).
  792.    Now you have the ONLY Multi-format player that works well with OS/2!
  793.    There may be a small clicks or interruptions during task-switching,
  794.    but hey, thats OS/2...!
  795.  
  796.      WINDOWS 3.x:
  797.      ------------
  798.    Cubic now runs fine under Windows 3.x too. Simply use the CP.PIF file
  799.    which should be included with your CP archive. You have to change your
  800.    paths and startup variables with the Windows PIF Editor. Then cp will
  801.    run under WIN 3.x even in background, but be prepared that this is very
  802.    slow on cpus < 66MHz.
  803.  
  804.  
  805.    3.4: Intelligent Memory Multiplying (IMM)
  806.    ------------------------------------------
  807.    (remember, this text also applies for AWE 32. Then GUS Ram is obviously
  808.     AWE 32 Ram :-) and it works a bit differently.)
  809.    What is Memory Multiplying? Well, that's exactly what it tells you. It
  810.    can increase the amount of GUS-memory when playing large modules or
  811.    MIDIs with many patches.
  812.    CUBIC-Player can make up to 8MB out of 1MB of GUS-Ram, so there
  813.    shouldn't be any problem with loading large modules.
  814.    IMM is used automatically when playing on a GUS and low of GUS-RAM.
  815.    There is no way of disabling it, because otherwise your modules wouldn't
  816.    be played correctly (there're just samples missing :-)
  817.    What it does? The first step is to look if any 16bit samples exist.
  818.    These are converted to 8bit samples, because the quality loss between
  819.    8 and 16bit is almost neglictable (If you only have ONE intrument at
  820.    moderate volume 8bit are enough, not for a complete audio track
  821.    such as on CD of course). If the samples now don't fit into GUS-RAM
  822.    CP crunches the lowest sample. So your HiHats and other instruments
  823.    that requiere high sampling rates should survive the process of
  824.    crunching sample data.
  825.    Other GUS-Player just crunch samples REGARDLESS OF THEIR PITCH, not CP.
  826.  
  827.    YOU'LL HEAR THE DIFFERENCE!
  828.  
  829.  
  830.  
  831.    3.5: CD-Audio
  832.    -------------
  833.    CP is now capable of playing standard Audio and Mixed CDs. Simply insert
  834.    the CD into your CD-Rom, start CP and go to the file selector. Then change
  835.    to your CD-Rom drive. Now you should see the audio tracks of your CD, or
  836.    if you have a mixed CD the Audio tracks will be located in the root 
  837.    directory. You can of course start the CD right away from the DOS prompt.
  838.    The track's name are TRACK??.CDA where ?? is the number 01-99.
  839.    When playing CD Audio there are two modes of CP. The first one is track
  840.    mode. Here Every Track is repeated once it has ended and you can not
  841.    change to the next track within CP. You can however change to Disk-Mode by
  842.    pressing ALT+D. Now CP plays the complete CD.
  843.    Keys: P         : pause CD
  844.          right     : +10 sec
  845.          left      : -10 sec
  846.          up        : -1 sec
  847.          down      : +1 sec
  848.          ctrl+up   : -1 min
  849.          ctrl+down : +1 min
  850.          ctrl+right: next track (disk mode only)
  851.          ctrl+left : previous track (disk mode only)
  852.    Help: If you have plugged your CD-Audio source into the Line-In connector
  853.          of your Sound Card use the -CN switch.
  854.  
  855.    If you want to analyse any other sound source (radio) you can do so by
  856.    connecting it to the LINE-IN or MIC source of your sound card. In the
  857.    File Selector there's a new drive listed above your normal drives: @
  858.    Change to this "drive" and you will find all the input sources from your
  859.    soundcard: line-in and mic.
  860.    In either of the three modes you can use the following features of CP:
  861.      a - analyser
  862.      g - graphic analyser (shift+g works too)
  863.      o - oscilloscopes
  864.      x - eXtended mode :-)
  865.      p - pause
  866.      sorry, but there's no -> würfel-mode <- available by now.
  867.    Help: This sampling and analysing mode by now works only with SB 2/PRO/16
  868.      and GUS. If you own a GUS Max please set it to normal GUS mode with
  869.      -cc10. If you own an AWE 32 you have to use its SB16 part with
  870.      -cc4. Sorry for all PAS and WSS users. Perhaps support for these
  871.      cards will come in one the the future versions.
  872.  
  873.  
  874.  
  875.    3.6: Double UltraSound
  876.    ----------------------
  877.    CP can adress 2 UltraSounds at a time and output on 4 channels
  878.    There are 2 modes: 2D and 3D.
  879.    The speakers have to be set up as shown in the diagrams.
  880.  
  881.        GUS1                         GUS1
  882.        [L]------[R]                 [L]------[R]
  883.  
  884.         2D                           3D
  885.                          [R] top
  886.        [L]------[R]                         /
  887.        GUS2                           / GUS2
  888.                     /
  889.                      [L] bottom
  890.  
  891.    CP will adress the first UltraSound as usual and the second one only
  892.    via its port. The amount of GUS memory will be the minimum of the 2
  893.    UltraSounds. You can the surround feature (F4) to make cp assign
  894.    the instruments to random points in space, or set the 3d-panning
  895.    by the Yyz command in XMs. This is a non standard command, and may be
  896.    changed in the future:
  897.         y=0:below, y=F:above, z=0:behind, z=F:in front
  898.    The 2 UltraSounds have to be properly inited before starting cp:
  899.     set ultrasnd=settings of GUS2
  900.     set ultra16=settings of GUS2 (if it has a DB or is GUSMAX)
  901.     ultrinit
  902.     set ultrasnd=settings of GUS1
  903.     set ultra16=settings of GUS1 (if it has a DB or is GUSMAX)
  904.     ultrinit
  905.    Then start cp with -cc11 [for 2D] or -cc12 [for 3D]
  906.           and -czPPP [port of GUS2]
  907.  
  908.  
  909.    3.7: Disk Writing
  910.    -----------------
  911.    You can now record your songs directly to disk into a standard WAV file.
  912.    For this there's a new device -cc40 which will pass every sound information
  913.    directly to hard disk. CP will create a WAV file named CPOUT???.WAV in the
  914.    current directory. You can set the -cc40 device to any playing mode CP
  915.    knows. For example: recording a 16bit stereo sample with 22Khz
  916.      -cc40,r22050,s,16
  917.    and a 8bit mono WAV with 33KHz
  918.      -cc40,r33075,m,8
  919.    If you record a WAV you should activate interpolation with -vf6, turn of
  920.    looping with -fl- and set a panning position with -va50. But feel free to
  921.    use ANY of CPs startup parameters to become the best output.
  922.    IMPORTANT: If you start CP in Disk Writing mode CP just behaves as normal,
  923.           so if you change parameters within CP like panning, volume, 
  924.           pitch, surround etc. this will have a direkt influence on the
  925.           WAV! You can however change to different viewing modes such as
  926.           x, g, o etc.
  927.           Of course you can also enable the echos of CP from the command
  928.           line if you wish.
  929.  
  930.  
  931.  
  932.    4: Notes, bugs, etc.
  933.    =====================
  934.  
  935.    4.1: Notes on the Implementation of the Formats
  936.    ------------------------------------------------
  937.  
  938.      XM: -Older XMs do not load. (claustr2.xm, shelter.xm), because that
  939.       format is completely different and will not be supported.
  940.       (unless I get a description...) Rewrite them with ft2!
  941.       Does anyone know exactly how to handle the auto vibrato effect?
  942.      -Yyz is used for 3d-panning:
  943.         y=0:below, y=F:above, z=0:behind, z=F:in front
  944.     DMF: -some fx missing
  945.     OKT: -some fx missing
  946.     PTM: -some fx missing (note slide)
  947.     AMS: -few fx missing... not extensively tested
  948.  
  949.  
  950.    4.2: Known Bugs
  951.    ----------------
  952.  
  953.     - cp crashes on some systems (this bug occurred between 0.96 and 1.0)
  954.       it might work with a different setup (boot with F5), though this
  955.       can only be a temporary solution. please tell us (if it works with
  956.       a clean boot) which driver, or which combination of drives causes
  957.       cp to crash on which soundcard. Does it crash with WSS or PAS at all?
  958.       strange thing... sorry if it happens!
  959.     - midis are not played 100% correctly all the time..
  960.       (docs, docs, docs, please! (but not the standard ones))
  961.       (especially about the .PAT format (not the SDK one))
  962.     - the first-note-after-a-loop in no-loops-mode bug
  963.     - If you press the <pause> key, the player may stop playing.
  964.       We could remove this bug, but then there will be another bug...
  965.       some keystrokes will be missed... hmm, there sure is another way... :)
  966.     - my GUS does not work :-(
  967.       OK, we know, that's because CP can't handle IRQs greater than 7.
  968.       You can avoid this problem by specifying the switches -cg,t
  969.       (Apparantly that's not our fault but DOS4GW's. The DOS Extender does
  970.        not pass IRQs above 7 from real mode correctly) As Every GUS owns a
  971.       second IRQ, that is normaly set to IRQ5 in 95% GUSes do work. If you
  972.       have set your second (or MIDI) GUS IRQ to above 7 CP will take 2 or
  973.       more seconds longer to load all the modules and will most probably
  974.       stop playing after a few seconds). You can solve this by changing your
  975.       SET ULTRASOUND=port,dma1,dma2,irq1,irq2 commmand in the autoexec.bat
  976.       to any free IRQ below 8, or use the above switches.
  977.  
  978.  
  979.   5: Information on Cubic Player
  980.   ===============================
  981.  
  982.     The player was started somewhere in 1993, (was it?) using Borland C++ 3.1
  983.     and TASM 3.1, and was used in VEX-intro, which was presented at the
  984.     Assembly '94. That version was still quite buggy, but the bugs did not
  985.     appear in the VEX-tune... In late September '94 I got Watcom C++ v10 and
  986.     transformed the sources to Watcom's C++ implementaton. Then the player
  987.     was given a user interface, which was worked out in the following
  988.     nine months. The playback quality was also improved, so you now have
  989.     one of the best and fastest module players. The mixer is especially fast
  990.     (that's what my speed test program told me, a simple loop per time count
  991.     program, no tricks) with multi channel modules that use panning, faster
  992.     than any other players I know of.
  993.     This is quite astonishing, since less than 5% of the player was coded in
  994.     assembler, the rest in C/C++. (900k source in C++, 20k source in ASM,
  995.     10k assembler object code, the rest in C/C++, takes 15 min to compile ;)
  996.     Cubic Player uses Rational Systems' DOS4G DOS extender, so the player
  997.     can use all (or 16M at maximum) your extended / expanded memory.
  998.     [no time for more facts, David!]
  999.  
  1000.  
  1001.  
  1002.    6: Greets, Credits
  1003.    ===================
  1004.  
  1005.       thanks go to:
  1006.       --------------
  1007.         Master of the Matrix / DN for great support
  1008.     Jens Uwe Rumstich / Green Apple
  1009.     Scholar / $EEN
  1010.     Abyss
  1011.     Matthias Beilicke
  1012.     Iron Eagle / TC
  1013.     Turcsányi Tamás aka Tragic for fileid design
  1014.     SS.C
  1015.         Chaos for nice little tool coding info.
  1016.         Crap for v1.666 idea :)
  1017.         Roadrunner for hidden part
  1018.  
  1019.  
  1020.       for ß-testing:
  1021.       ---------------
  1022.     the Sodomist
  1023.     Scholar / $EEN
  1024.     Green Apple
  1025.     Zomb
  1026.     Shadow Dancer / $EEN
  1027.     Encounter
  1028.     the Frontier
  1029.     Michael Erdmann
  1030.     Flying Kiwi
  1031.  
  1032.  
  1033.       greets:
  1034.       --------
  1035.     THE COEXiSTENCE
  1036.     Green Apple
  1037.     Future Crew
  1038.     Legend Design
  1039.     Cascada
  1040.     Iguana
  1041.     $EEN
  1042.  
  1043.     Libertine & "Mr Vectorengine"-Jinx!
  1044.     AVATAR / LD
  1045.     Zodiak / Cascada
  1046.     SiPiYou / VD
  1047.     Zomb
  1048.     Ratzkartoffel for nice hints!
  1049.     Christophe Yvon for hints
  1050.     Moku / Assembly Organizing
  1051.     Baldric / Extreme
  1052.     Cygnus-X1 and Judge Dredd for releasing info on AWE
  1053.  
  1054.     Pole & Garlick
  1055.     Michael Erdmann
  1056.     David "that cool spanish guy that writes loong and booring letters"
  1057.       Márquez Hernández :)
  1058.  
  1059.  
  1060.  
  1061.       credits:
  1062.       ---------
  1063.  
  1064.     Niklas Beisert / pascal
  1065.       -code
  1066.       -design
  1067.       -fido support
  1068.       -docs
  1069.       -organizing
  1070.  
  1071.     Dirk Jagdmann / DOJ
  1072.       -feature ideas
  1073.       -organizing
  1074.       -design
  1075.  
  1076.     Bertolt Meyer / ?hook
  1077.       -ex internet support
  1078.  
  1079.  
  1080.  
  1081.   6.1: Addresses
  1082.   --------------
  1083.  
  1084.     Please note, that we can not reply to every mail we get.
  1085.     Any question already answered in one of the documentation files
  1086.     will simply be neglected. Please also note that we will most probably
  1087.     not give permission to anyone to use this version in a commercial
  1088.     production. Please contact ROMWARE (see below) for CP1.5 sublicenses.
  1089.  
  1090.  
  1091.     SNAILMAIL:
  1092.       Niklas Beisert
  1093.       Oberstrasse 84
  1094.       20149 Hamburg
  1095.       Germany
  1096.  
  1097.     FiDO-NET:
  1098.       Niklas Beisert@2:2437/301.44
  1099.  
  1100.     INTERNET:
  1101.       lukas@harz.de, subj:cp    (wrong subject, no reply!!! :) )
  1102.  
  1103.  
  1104.     SUPPORT BBS:
  1105.    +---------------------------------------+
  1106.    |     DIGITAL NIGHTMARE                 |
  1107.    |                                       |
  1108.    |   +49-5121-157107  [33.6 USR]         |
  1109.    |   +49-5121-39236   [16.8 ZyXEL]       |
  1110.    |   +49-5121-157636  [64k/128kISDN]     |
  1111.    |                                       |
  1112.    | with a special menu for cubic player  |
  1113.    +---------------------------------------+
  1114.  
  1115.  
  1116.  
  1117.        Have fun with CUBIC-Player...
  1118.  
  1119.                       meet you at SYMPOSIUM '96 in Hamburg
  1120.  
  1121.  
  1122.                                   pascal / doj
  1123.